<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
    <meta http-equiv="Content-Style-Type" content="text/css" />
    <meta name="GENERATOR" content="Quadralay WebWorks Publisher Professional Edition 7.0.2.1206" />
    <meta name="TEMPLATEBASE" content="book-w-index" />
    <meta name="LASTUPDATED" content="10/29/02 14:46:24" />
    <title>Preface</title>
    <link rel="StyleSheet" href="document.css" type="text/css" />
    <link rel="StyleSheet" href="catalog.css" type="text/css" />
    <link rel="Table of Contents" href="index.html" />
    <link rel="Previous" href="midletsLOC.html" />
    <link rel="Next" href="intro.html" />
    <link rel="Index" href="midletsIX.html" />
  </head>

  <body>

    <table class="full-width" id="SummaryNotReq1">
      <tr><td class="sun-darkblue">&#160;</td></tr>
      <tr><td class="sun-lightblue">&#160;</td></tr>
      <tr><td class="go-right">
        <a accesskey="c" href="index.html">
          <img id="LongDescNotReq1" src="images/toc.gif" border="0"
            alt="Contents" /></a>
	<a accesskey="p" href="midletsLOC.html">
	  <img id="LongDescNotReq2" src="images/prev.gif" border="0"
            alt="Previous" /></a>
        <a accesskey="n" href="intro.html">
	  <img id="LongDescNotReq3" src="images/next.gif" border="0"
            alt="Next" /></a>
        <a accesskey="i" href="midletsIX.html">
	  <img id="LongDescNotReq4" src="images/index.gif" border="0"
            alt="Index" /></a>
        </td>
      </tr>
    </table>

<a name="wp1182"> </a><h2 class="pNewHTMLPage">
Preface
</h2>
<hr class="pHr"/>
<a name="wp2778"> </a><p class="pBody">
<em class="cEmphasis">Creating MIDlet Suites</em> describes how to create MIDlets and package them into MIDlet suites using the MIDP Reference Implementation<em class="cEmphasis">. </em>It is not a programming guide, so although it covers the required steps in MIDlet creation and discusses some interfaces, classes, and methods, it does not comprehensively cover the MIDP Reference Implementation APIs.
</p>
<a name="wp3890"> </a><p class="pBody">
This guide assumes that you have already installed the product, as described in the <em class="cEmphasis">Installing MIDP</em>, and that you are familiar with both the Java&#8482; programming language and the <em class="cEmphasis">MIDP 2.0 Specification</em>.
</p>
<a name="wp3897"> </a><p class="pBody">
The Hello MIDlet is used as an example throughout this guide. The code for the Hello MIDlet is in the <em class="cEmphasis">midpInstallDir</em><code class="cCode">\src\example</code> directory, where <em class="cEmphasis">midpInstallDir</em> is the directory that holds your installation of the MIDP Reference Implementation. It is reproduced in <a  href="appx-helloworld.html#wp997084"><span style="color: #3366CC">Appendix&#160;A,  &#8220;Code for the Hello MIDlet</span></a>.&#8221;
</p>
<a name="wp2788"> </a><h2 class="pHeading1">
How This Book Is Organized
</h2>
<a name="wp2789"> </a><p class="pBody">
This book has the following chapters:
</p>
<a name="wp128"> </a><p class="pBody">
<a  href="intro.html#wp9095"><span style="color: #3366CC">Chapter&#160;1</span></a> introduces MIDlets and the environments in which they run.
</p>
<a name="wp2711"> </a><p class="pBody">
<a  href="create.html#wp9095"><span style="color: #3366CC">Chapter&#160;2</span></a> describes the basics of creating a MIDlet.
</p>
<a name="wp2712"> </a><p class="pBody">
<a  href="compile.html#wp9095"><span style="color: #3366CC">Chapter&#160;3</span></a> provides the steps to compile and preverify your MIDlet.
</p>
<a name="wp2828"> </a><p class="pBody">
<a  href="package.html#wp9095"><span style="color: #3366CC">Chapter&#160;4</span></a> shows you how to package your MIDlet.
</p>
<a name="wp2848"> </a><p class="pBody">
<a  href="publish.html#wp9095"><span style="color: #3366CC">Chapter&#160;5</span></a> describes how to publish your MIDlet.
</p>
<a name="wp2835"> </a><p class="pBody">
<a  href="test.html#wp9095"><span style="color: #3366CC">Chapter&#160;6</span></a> describes how to run your MIDlet suite in a debugger and how to report problems.
</p>
<a name="wp3343"> </a><p class="pBody">
<a  href="appx-helloworld.html#wp997082"><span style="color: #3366CC">Appendix&#160;A</span></a> reproduces the example code for the Hello MIDlet.
</p>
<a name="wp2854"> </a><h2 class="pHeading1">
Using Operating System Commands
</h2>
<a name="wp2855"> </a><p class="pBody">
This document may not contain information on basic UNIX&#174; or Microsoft Windows commands and procedures such as opening a terminal window, changing directories, and setting environment variables. See the software documentation that you received with your system for this information.
</p>
<a name="wp3393"> </a><h2 class="pHeading1">
Typographic Conventions</h2><div align="left">
<table border="0" cellpadding="7" summary="This table describes the typographic conventions used in this guide." id="wp3354">
  <caption><a name="wp3354"> </a><div class="pTableCaption">

</div>
</caption>
<thead>
<tr  align="center">    <th  class="sun-verylightblue" scope="col"><a name="wp3360"> </a><div style="text-align: left" class="pTableHead">
Typeface
</div>

</th>
    <th  class="sun-verylightblue" scope="col"><a name="wp3362"> </a><div style="text-align: left" class="pTableHead">
Meaning
</div>

</th>
    <th  class="sun-verylightblue" scope="col"><a name="wp3364"> </a><div style="text-align: left" class="pTableHead">
Examples
</div>

</th>
</tr>
</thead>
  <tr align="left">    <td><a name="wp3366"> </a><div class="pTableText">
<code class="cCode">AaBbCc123</code>
</div>
</td>
    <td><a name="wp3368"> </a><div class="pTableText">
The names of commands, files, and directories; on-screen computer output
</div>
</td>
    <td><a name="wp3370"> </a><div class="pTableText">
Edit your <code class="cCode">.login</code> file.
</div>
<a name="wp3371"> </a><div class="pTableText">
Use <code class="cCode">ls -a</code> to list all files.
</div>
<a name="wp3372"> </a><div class="pTableText">
<code class="cCode">% You have mail</code>.
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp3374"> </a><div class="pTableText">
<span class="cUserType">AaBbCc123</span>
</div>
</td>
    <td><a name="wp3376"> </a><div class="pTableText">
What you type, when contrasted with on-screen computer output
</div>
</td>
    <td><a name="wp3378"> </a><div class="pTableText">
<code class="cCode">% </code><span class="cUserType">su</span>
</div>
<a name="wp3379"> </a><div class="pTableText">
<code class="cCode">Password:</code>
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp3381"> </a><div class="pTableText">
<em class="cEmphasis">AaBbCc123</em>
</div>
</td>
    <td><a name="wp3383"> </a><div class="pTableText">
Book titles, new words or terms, words to be emphasized
</div>
<a name="wp3384"> </a><div class="pTableText">
&#160;
</div>
<a name="wp3385"> </a><div class="pTableText">
&#160;
</div>
<a name="wp3386"> </a><div class="pTableText">
Command-line variable; replace with a real name or value
</div>
</td>
    <td><a name="wp3388"> </a><div class="pTableText">
Read Chapter 6 in the <em class="cEmphasis">User&#8217;s Guide</em>.
</div>
<a name="wp3389"> </a><div class="pTableText">
These are called <em class="cEmphasis">class</em> options.
</div>
<a name="wp3390"> </a><div class="pTableText">
You <em class="cEmphasis">must</em> be superuser to do this.
</div>
<a name="wp3391"> </a><div class="pTableText">
&#160;
</div>
<a name="wp3392"> </a><div class="pTableText">
To delete a file, type <code class="cCode">rm</code> <em class="cEmphasis">filename</em>.
</div>
</td>
</tr>
<tr><td colspan="15"><hr class="pTableHr" /></td></tr>
</table>
</div>
<h2 class="pHeading1">

</h2>
<a name="wp3394"> </a><p class="pBody">

</p>
<a name="wp3416"> </a><h2 class="pHeading1">
Shell Prompts</h2><div align="left">
<table border="0" cellpadding="7" summary="This table describes the shell prompts that preceed examples of commands." id="wp3401">
  <caption><a name="wp3401"> </a><div class="pTableCaption">

</div>
</caption>
<thead>
<tr  align="center">    <th  class="sun-verylightblue" scope="col"><a name="wp3405"> </a><div style="text-align: left" class="pTableHead">
Shell
</div>

</th>
    <th  class="sun-verylightblue" scope="col"><a name="wp3407"> </a><div style="text-align: left" class="pTableHead">
Prompt
</div>

</th>
</tr>
</thead>
  <tr align="left">    <td><a name="wp3409"> </a><div class="pTableText">
C shell 
</div>
</td>
    <td><a name="wp3411"> </a><div class="pTableText">
<code class="cCode">%</code>
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp3413"> </a><div class="pTableText">
Microsoft Windows
</div>
</td>
    <td><a name="wp3415"> </a><div class="pTableText">
<em class="cEmphasis">directory</em><code class="cCode">&gt;</code>
</div>
</td>
</tr>
<tr><td colspan="15"><hr class="pTableHr" /></td></tr>
</table>
</div>
<h2 class="pHeading1">

</h2>
<a name="wp3417"> </a><p class="pBody">

</p>
<a name="wp3744"> </a><h2 class="pHeading1">
Related Documentation
</h2>
<a name="wp3807"> </a><p class="pBody">
The following documentation is included with this release:</p><div align="left">
<table border="0" cellpadding="7" summary="This table lists the documentation that comes with this product." id="wp3748">
  <caption><a name="wp3748"> </a><div class="pTableCaption">

</div>
</caption>
<thead>
<tr  align="center">    <th  class="sun-verylightblue" scope="col"><a name="wp3752"> </a><div style="text-align: left" class="pTableHead">
Application
</div>

</th>
    <th  class="sun-verylightblue" scope="col"><a name="wp3754"> </a><div style="text-align: left" class="pTableHead">
Title
</div>

</th>
</tr>
</thead>
  <tr align="left">    <td><a name="wp3756"> </a><div class="pTableText">
All
</div>
</td>
    <td><a name="wp3761"> </a><div class="pTableText">
<em class="cEmphasis">Release Notes</em>
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp3763"> </a><div class="pTableText">
Installing
</div>
</td>
    <td><a name="wp3768"> </a><div class="pTableText">
<em class="cEmphasis">Installing MIDP</em>
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp3770"> </a><div class="pTableText">
Running and managing security for emulator 
</div>
</td>
    <td><a name="wp3775"> </a><div class="pTableText">
<em class="cEmphasis">Using MIDP</em>
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp3779"> </a><div class="pTableText">
Porting the MIDP Reference Implementation
</div>
</td>
    <td><a name="wp3785"> </a><div class="pTableText">
<em class="cEmphasis">Porting MIDP</em>
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp3787"> </a><div class="pTableText">
Creating and building MIDlets
</div>
</td>
    <td><a name="wp3792"> </a><div class="pTableText">
<em class="cEmphasis">Creating MIDlet Suites</em>
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp3794"> </a><div class="pTableText">
Viewing reference documentation created by the Javadoc&#8482; tool
</div>
</td>
    <td><a name="wp3799"> </a><div class="pTableText">
<em class="cEmphasis">API Reference</em>
</div>
</td>
</tr>
  <tr align="left">    <td><a name="wp3801"> </a><div class="pTableText">
Looking at examples
</div>
</td>
    <td><a name="wp3806"> </a><div class="pTableText">
<em class="cEmphasis">Example Overview</em>
</div>
</td>
</tr>
<tr><td colspan="15"><hr class="pTableHr" /></td></tr>
</table>
</div>
<p class="pBody">

</p>
<a name="wp3590"> </a><h2 class="pHeading1">
Accessing Sun Documentation Online
</h2>
<a name="wp3591"> </a><p class="pBody">
The Java Developer Connectionsm web site enables you to access Java platform technical documentation on the Web:
</p>
<a name="wp3592"> </a><p class="pBody">
<a href="http://developer.java.sun.com/developer/infodocs/" target="_blank">
<span class="cWebJump">http://developer.java.sun.com/developer/infodocs/</span></a>
</p>
<a name="wp3593"> </a><h2 class="pHeading1">
Sun Welcomes Your Comments
</h2>
<a name="wp3594"> </a><p class="pBody">
We are interested in improving our documentation and welcome your comments and suggestions. You can email your comments to us at:
</p>
<a name="wp3595"> </a><p class="pBody">
<a href="mailto:docs@java.sun.com" target="_blank">
<span class="cEmail">docs@java.sun.com</span></a>
</p>

    <p>&#160;</p>
    <hr class="pHr" />

    <table class="full-width" id="SummaryNotReq2">
      <tr>
        <td class="go-left">
          <a accesskey="c" href="index.html">
	    <img id="LongDescNotReq1" src="images/toc.gif" border="0"
              alt="Contents" /></a>
	  <a accesskey="p" href="midletsLOC.html">
	    <img id="LongDescNotReq2" src="images/prev.gif" border="0"
              alt="Previous" /></a>
	  <a accesskey="n" href="intro.html">
	    <img id="LongDescNotReq3" src="images/next.gif" border="0"
              alt="Next" /></a>
	  <a accesskey="i" href="midletsIX.html">
	    <img id="LongDescNotReq4" src="images/index.gif" border="0"
              alt="Index" /></a>
        </td>
        <td class="go-right">
          <span class="copyright">Creating MIDlet Suites <br /> MIDP Reference Implementation, Version 2.0 FCS</span>
        </td>
      </tr>
    </table>

    <p>&#160;</p>
    <p class="copyright"><a 
       href="copyright.html">Copyright</a> &#169;
       2002 Sun Microsystems, Inc. All rights reserved.</p>	
  </body>
</html>
